[ <<- ->> ] Succubus Heart [ <<- ->> ]
[<->] The Succubus Gameplay Mod [<->]

Created by : Michael "Spirit Shard" Stanich
Site - michaelpstanich.com
YouTube - youtube.com/michaelpstanich
Discord (The Broken Chatbox) - https://discord.gg/h3vB7S4FEw
Ko-Fi (Donations! =^-^=) - https://ko-fi.com/michaelpstanich
_
_____
[ <<- ->> ] Self Promotion [ <<- ->> ]
Hey there, so, like, I know no one likes the whole "beg for money" stuffs, so I'll keep this short. Making stuff is hard work and takes a ton of time, so if you'd like to help support my endeavors then please consider donating direction through Ko-Fi! - https://ko-fi.com/michaelpstanich

Supporters get perks through our Discord, The Broken Chatbox (https://discord.gg/h3vB7S4FEw) with access to exclusive channels, early and exclusive releases from me, and, best of all, the role is permanent! No recurring donations nonsense! And don't worry, Succubus Heart is NOT becoming a paid mod! All full releases will be distributed through discord as usual (and occasionally updated on other platforms, such as Loverslab or NexusMods). So if you enjoy Succubus Heart or any of my other works, and would like to make it easier for me to support these projects, please consider donating! (or just send me kind messages, both give me fuzzy feelings =^.^=)
_
_____
[ <<- ->> ] Latest Update News [ <<- ->> ]
4.12.9 DEV is here! All this needs before the 4.13 release version is some testing! I'm releasing this one outside of Discord because, while it's still not fully tested (I did a LOT more work than I expected between release versions here), it contains all the features that will be in 4.13 and I'd like to get feedback on how things are going. So if you try the new update, please let me know what you think and report any bugs you find! I'm also stupidly excited about my potential fix to Soul Pets, though it still needs extensive testing to see if it's 'actually' fixed. (It's a fix for Soul Pets not properly replicating the souls of NPCs that are randomly spawned. This new fix uses some obscure SKSE functions and fun logic to try and capture the "base" version. Meaning, it won't spawn random NPCs from the same level list anymore!.. hopefully..)
_
_____
[ <<- ->> ] Important News [ <<- ->> ]
I've started taking a new approach to how I develop Succubus Heart, which leads to some changes in how the mod is both tested and distributed. From now on I'll be releasing what I'll call "DEV" versions, these versions will normally only be distributed via our Discord, The Broken Chatbox (https://discord.gg/h3vB7S4FEw), and will simply contain any changes I've made that day working on the mod. which means...

In-Dev versions from this point forward, MAY BE UNSTABLE and may contain missing, incomplete, or outright broken mechanics!

While I'll try my best not to break in-dev versions, since they're effectively just whatever I got 'finished' before I quit working on it for the day, they may have incomplete functions, uncompiled scripts, and are generally untested. Back up your save before using these versions, YOU'VE BEEN WARNED! (Note : I don't release "unlaunchable/unplayable versions")

If you'd like to see updates for Succubus Heart, need support, have suggestions, or anything else related to my work, I strongly recommend joining our Discord! (https://discord.gg/h3vB7S4FEw)
_
_____
_
[ <<- ->> ] What is Succubus Heart? [ <<- ->> ]
Succubus Heart is an adult gameplay mod focused on creating new ways to approach playing Skyrim with both new progression and new game mechanics. These mechanics give the player the power of a succubus enabling the use of life-drain and great sacrificial powers. Succubus Heart is built around the idea of being a complimentary mod and should be compatible with nearly every mod out there!
_
[ <<- ->> ] What's So Unique? [ <<- ->> ]
Succubus Heart isn't a transformation mod, or a power fantasy mod, instead mechanics are focused on making gameplay more interesting and offering the player new ways to approach situations. Succubus Heart can also be used on male characters, turning them into a soul sucking Incubus! While most succubus mods focus on the demon-archtype, Succubus Heart's approach is based on a fantasy race of life-weavers giving a more human-but-powerful vibe. However if you want some succubus transformations or want to use Succubus Heart alongside other succubus mods nothing is stopping you!
_
[ <<- ->> ] Mechanics [ <<- ->> ]
<-> Status Drain - Drain Health/Magicka/Stamina from your victims and use them to your advantage!
<-> Heart System - Earn XP through sex acts and spend them to improve your succubus abilities!
<-> Skill Leveling - Use overflowing Force from your victims to level skyrim's native skills! (no more grinding iron daggers, grind NPCs instead!~)
<-> Succubus Passives - Enable strong Succubus Powers as you level to improve your abilities across the board!
<-> Sex/Death Drops - Extract Sperm and Breast Milk from orgasms or take their souls after victims are drained away!
<-> Soul Pets - Replicate nearly NPC's Soul and summon them as a Pet to fight/hump alongside you!
<-> Soul Forge - Use excess forces to replicate useful items on the fly!
<-> Combat Seduction - A simple combat submit mod, integrated right into Succubus Heart for an easy all-in-one experience!
<-> Death Override Mode - Tired of death? DOM turns Skyrim into a Rouge-Lite with a new respawn system and mechanics!
_
[ <<- ->> ] WARNING : Script Mod [ <<- ->> ]
While Succubus Heart is fairly light weight in the majority of cases it is a heavily script based mod. If your game is already having issues with script latency and overload I recommend backing up your saves before trying out Succubus Heart (and/or possibly decreasing your script load). I've done what I can to ensure Succubus Heart is as bug/error free as possible however under script lag any mod can begin throwing up errors and I can't guarantee Succubus Heart's performance.
_
_____
[ <<>> ] What's Included [ <<>> ]
- Docs (_Read Me - _Changelog - _Help Document)
- Data (Everything for the core mod)
_
[ <<>> ] Requirements [ <<>> ]
Skyrim Special Edition
- Skyrim SE or AE (Works on both)
- SKSE - Latest Available [ http://skse.silverlock.org/ ]
- SexLab SE v1.63 BETA or newer [ https://www.loverslab.com/topic/91861-sexlab-framework-se-163-beta-2-april-5-2018/ ]
- SkyUI SE 5.2 or newer [ https://www.nexusmods.com/skyrimspecialedition/mods/12604 ]
_
[ <<>> ] Installing / Updating [ <<>> ]
Mod Manager Install : Succubus Heart's file structure should be automatically recognized by modern mod managers such as MO2!
_
Manual Install : Simply copy Succubus Heart's "Data" folder to your Skyrim install, merging with that "Data" folder, then install any optional content you wish to use. When using 5.0 or newer you'll need to enable the mod in the MCM.
_
Updating newer than 4.6 : Just install over the old version using the install method.
_
Updating older than 4.6: If you're updating from a version before 4.6, 4.6 must be installed first before updating to newer versions! After installing 4.6, load your character save, wait for the update to finish (about 1 second), and make a new save. Now exit and install the newest version, now you can load the new character save you made and keep your progress. Updating directly to newer versions from versions before 4.6 without these steps will result in your Succubus Heart progress being completely lost and things may break beyond repair!

If you're using version 2.73x or below you'll need to do a 'clean' save before moving to 3.0+
_
[ <<>> ] Uninstalling / Removal [ <<>> ]
Disable the mod then perform a clean save. After the clean save, delete the "Succubus Heart.esp" and all files pre-fixed with "SuH_" and other files from the Succubus Heart mod from your Skyrim's "Data" folder. It is recommended to either load a game from before you had Succubus Heart installed or start a new game after uninstalling. Mod managers should also be able to remove all the associated files without issue.
_
[ <<>> ] External Mod Support [ <<>> ]
Succubus Heart features are easy to access and modify, if anyone wants to create add-ons and additional mods feel free! If you have questions or any issues feel free to message me.
_
[ <<>> ] Incompatible Mods [ <<>> ]
- Follower Framework mods may have issues with Soul Pets, so expect some weirdness when using these mods.
- Any mod that 'locks' player status or tries to manage stats based on non-dynamic values. (Succubus Heart dynamically changes values and can have issues with mods that try to do this with Skyrim's default values without dynamically checking. Sadly this is on them and there's nothing I can do about it.)
- Regal Glow applies an 'invisible' armor and can cause some issues with mods detecting nudity. In these cases add an exception to 'SuH_armor_regalglow' or the blank name entry in the mod's exception MCM (if it has one). I've done what I can on my end to try and make it compatible.
_
[ <<>> ] Known Issues [ <<>> ]
- Using Soul Pets with other Animal Follower mods may cause strange behavior on both mods. (I recommend not summoning a Soul Pet while the other Animal Follower is following you)
- Soul Pets will sometimes and sometimes not teleport to the player when they should or shouldn't, if your pet is missing just re-summon them.
- Combat Seduction will sometimes trigger 'overlapping' animations under heavy script lag
- Death Override Mode can cause major issues with certain quests if you die and move outside of the quest's dedicated area. (When in this situation disable Death Override for the quest's duration)
- General script latency problems do to the nature of script modding (Heavy script lag may cause issues with Succubus Heart)
- Some lists in the MCM may bug out when canceled out of. No idea why.
_
[ <<>> ] FAQ [ <<>> ]
Q: Is this mod still being developed and updated?
A: Short answer is yes, long answer is a bit more complicated. I have a lot of projects and a life to live, so updates are usually spaced a bit apart.
_
Q: Why was Official Oldrim (SLE) support dropped?
A: Unfortunately I just can't work with Oldrim's Creation Kit anymore, it just crashes too much on my newer hardware. This means I'm stuck with SSE whether I like it or not, on-top of this new features being added to Succubus Heart now require SSE to function properly and back-porting to SLE just simply takes too much time for me to justify.
_
Q: I don't understand, when I use the "Sexual Entice/Enrage" I have no health!
A: Read the spell and it's mechanics carefully (it's explained in several locations, including on the spell itself). Sexual Entice and other seduction spells reduce the player's Max Health/Magicka/Stamina by a large percentage. This percentage is decreased by a Passive found in the MCM.
_
Q: Can I still level like in vanilla?
A: Of course! Succubus Heart doesn't alter any external scripts so other leveling methods should work as they always have.
_
Q: Can I use this mod as a male character?
A: Yep! Succubus Heart supports all genders!
_
Q: The MCM isn't showing and nothing seems to work!
A: Sounds like something installed incorrectly, try a clean install of the mod and make sure your files downloaded/extracted properly.
_
Q: _____ feels overpowered / underpowered, can you balance it?
A: I can try! If you have balance concerns make sure to send them my way and I'll try my best to work on it.
_
Q: I thought Soul Pets was going to be a completely separate mod, why is it now integrated?
A: In honesty I completely screwed up the stand-alone's code so instead of re-writing from scratch (again) I just moved onto making an integrated version first. I'll work on the stand-alone version at some point (maybe...).
_
Q: But I didn't want Soul Pets, can it be removed?
A: No, however I've built it in such a way that it doesn't do anything if you don't use it so just ignore the Soul Pets MCM if you don't want to use it.
_
Q: Why did you re-write the mod and end up removing features?
A: Removing features was never part of the plan but rather just a side effect. The original write was based on a flawed framework and the entire mod had become a grouping of work-arounds, causing bugs which I couldn't fix. The re-write allowed me to rebuild the foundation and build a more cohesive mod with better mechanics and synergy.
_
Recent Changes (Check the full changelog for more info)
[Spoiler]
Succubus Heart [4.12.1] (in-dev)

	in-dev Note : This version has several incomplete changes and may have some features as non-functional
	
	4.12.1
	
	NOTE : Finished updating rest of MCM
	
	Changed : Updated the Help MCM, added Key Terms and Vocabulary, added Random Notes, Added Discord Link
	
	4.12.0
	
	Added : New Actives menu to the MCM (Currently empty, it's here for future updates)
	
	Changed : Re-organized entries in the MCM
	Changed : Separated the Status and Settings menu (Settings menu is now near the bottom)
	Changed : Perks menu is now the "Titles" menu (Function unchanged, it's for a future update)
	Changed : Rewrote most of the MCM to be more concise, clear, and accurate while adding additional helper text to many entries
	Changed : Modified and Added Comments in the Source Code for easier reading
				(Should make it easier to make additions/modify Succubus Heart should anyone wish to do so)
	Changed : Added spaces in the Soul Pets and Soul Forge selection menus to help prevent accidental selections/deletions
	Changed : Stacks are now referred to "Bonus" (Function unchanged for now)
	Changed : Sperm and Milk stacks are now merged into "Fluid Bonus" (Function unchanged for this update)
	Changed : Altered some settings defaults
	Changed : Temporarily hid status overrides in Status MCM (Can still be set manually via commands but may break until officially re-enabled)
_____
Succubus Heart [4.11]
	- Added. "Revive Cost" option to Death Override Mode
	 - - Reduces Status Caps by a certain percentage when reviving in DOM
	- Added. "Never Die Mode" option to Death Override Mode (Requires Death Override Mode to be enabled)
	 - - This mode has the player heal and stand back up after the bleed out delay rather than returning to the Succubus Realm
	 - - NOTICE : It's recommended to disable "lose items" and similar options while using Never Die Mode and instead use the Revive Cost option
	= Fixed. "Seducer" passive allowing the player to purchase upgrades without enough Status Cap
	- Fixed. the All Consuming Chest should no longer give free XP every time it was opened and closed
_____
Succubus Heart [4.10]
	- Modder Note. All non-pet items now trigger based on keywords, you can now add the "SuH_key_  " keyword to any item to trigger the appropriate effect. (Check SuH_Status or SuH_Main_player for keywords available)
	_____
	- Changed.  Devious Partner Passive
	 - - Gold Up is now +2 stolen every level instead of +1
	 - - Conversion Up is now +5% of Mind Rating instead of +20%
	- Changed.  Seducer Passive
	 - - Status Caps reduce by 60 instead of 20 per rank
	 - - Cost Down decreases by 30% instead of 10% (Requires 3 levels to nullify instead of 9)
	- Changed. Updated some Help and Error text
	- Changed. Added Brackets and slightly changed names of Succubus Heart items
	- Changed. Removed "empty" magic effects on consumables and removed all other ingredient effects
	 - - Will be adding new effects in the future so they can legitimately be used in alchemy without drawbacks
	_____
	- Removed.  guaranteed "+1" effect from all passives that had it
	 - - This means Passives can now have an effect of zero if BDSM isn't high enough (before it would always add +1, preventing this)
	_____
	- Added. Refresh Stone Item
	 - - Resets Passives without costing HeartXP
	 - - Added Refresh Stone to Spirit's potential items for sale
	- Added. Setting "End Act On Attack"
	 - - Attempts to end Acts when a participent is attacked, can cause some animations to end improperly
	- Added. Consuming Sperm should now apply an oral cum effect
	- Added. "Submit Cooldown" Option
	 - - Changes how long a character is immune to Combat Seduction after the end of an act
	- Added. Permanent storage chests near the entry point of the Succubus Realm
	_____
	- Fixed. Perks should now properly effect BDSM Rating similar to items without having to reset passives
	 - - Cap increases should have increased BDSM rating when aquired but wouldn't until BDSM was fully re-calculated by a reset
	- Fixed. Regal Glow should now update its armor rating value properly
	= Fixed. Regal Glow should now display the correct values in the MCM when re-loading/entering the menu"
	- Fixed. Added missing flags on some SuH background functioning spells
	 - - This should prevent NPCs from reflecting/resisting effects, remove some rare visual effects that would randomly appear, and functions like "calm during act" should work more consistantly
	- Fixed. Some timers/cooldowns should no longer count-down when in menus
	- Fixed. Combat Seduction should be more responsive to ignoring acts and behave more reliably
	- Fixed. Sperm and Milk acquisition and application on Orgasms should work more reliably and be compatible with more mods
	- Fixed. Characters that revive should more reliably prevent double drops
	- Fixed. Re-implemented Combat Seduction Cooldown, now called Submit Cooldown. (Still somewhat unreliable)
	- Fixed. Some typos and incorrect numbers in the MCM
	_____
	+ Milk and Sperm calculations are now a SuH_Fun function (MilkCalc and SpermCalc)
	+ Orgasms now use the Milk/Sperm function instead of an equip method
	+ SuH_dyna_active will now try to remove itself OnLoad, this is to help with refreshing the script
_____
Succubus Heart [4.9]
	- Changed. DOM now fully recovers Status (or tries to at least - Required to fix some glitches)
	= Changed. Decreased Soul Forge Memory Increase Cost
	- Changed. Passive Reset Cost now scales based on how many points have been spent (was based on level)
	= Changed. Increased value of pet soul items
	- Added. Passive Cap Excel which allows status to exceed the Status Cap (50% Body Rating per-rank) and slow the decay
	 - - Note : When exceeding past the Status Cap, Status will slowly decay and convert into force
	- Added. Soul of Pet Skeever item
	- Added. Soul of Pet Riekling item
	- Added. Soul of Pet Draugr item
	- Added. Toggle for Vigilant of Stendarr Hostility in Settings MCM
	= Fixed. Follower's Temporary Bow is now removed from inventory when returning pets home (Vanilla fix)
	= Fixed. DOM should now return the player to the Succubus Realm properly when knocked down without recovery options (ex. Absorption or external healing)
	= Fixed. Soul Pets not properly gaining XP in combat or being removed on Death
	= Fixed. Soul Forge MCM showing the wrong cost for items in memory
	= Fixed. Soul Forge MCM showing wrong memory increase cost after increasing memory
_____
Succubus Heart [4.8]
	- Changed. Updated Soul Pet MCM tutorial pop-up to reflect changes
	- Changed. Spirit will now have more stock for sale
	= Changed. Removed Slot Numbers on Soul Pets MCM
	= Changed. Soul Pets now scale by Status Percentages rather than relying on difficulty scaling
	- Removed. Death Override Mode no longer set status at 30%
	- Added. 'Lose Blood Chips On Death" Option for Death Override Mode
	- Added. Soul Forge is now integrated
	 - - Accessed in the Soul Forge MCM menu, now showing a tutorial message on first entry
	 - - Use Blood Chips to forge items instantly from memory
	 - - To add an item to memory select an item from your inventory (using the Soul Forge MCM) to start analyzing it
	 - - Analysis will complete over time however a small boost is gained when forging other items
	 - - When Analysis reaches 100%, if there is an open memory slot the item will be added
	 - - If Analysis reaches 100% and there are no slots available some progress is lost and Analysis will continue
	 - - If an item is already in memory, doesn't have a name, or is a Succubus Heart Item it can't be Analyzed
	 - - Items can be removed from memory in the MCM to open slots
	 - - Slots available can be expanded (up-to 50) using HeartXP
	- Added. Create Blood Chips from Health Cap to the Soul Forge MCM
	- Added. Summon Most Recent Pet to Pet Self Spell
	= New Soul Pets System Changes
		= When updating to 4.8 DEV Pets will most likely lose their names and need to be re-named manually
	 - - Soul Pets that have no default name will be auto-named "Pet"
	 - - Soul Pets can be renamed using the MCM
	 - - Soul Pets scale their Status based on Level
	- Added. Pet Dog Soul which adds a Dog Soul to an open Soul Pet Slot
	 - - Also added to Spirit's possible items for sale
	- Added. Pet Husky Soul which adds a Husky Soul to an open Soul Pet Slot
	 - - Also added to Spirit's possible items for sale
	- Fixed. Fixed losing gold with Death Override even when Lose Gold on Death was disabled
	- Fixed. Some defaults that should have been disabled on new games
	- Fixed. Succubus Realm 'Return to last entry' just returning directly back
	 - - (Will need to re-enter an interior for this to fix itself)
[/Spoiler] 